<div id="Avoiding-substitution"></div>
<div class="header">
<p>
Next: [[cvs: Substitution modes#Substitution modes|Substitution modes]], Previous: [[cvs: Using keywords#Using keywords|Using keywords]], Up: [[cvs: Keyword substitution#Keyword substitution|Keyword substitution]] &nbsp; |[[cvs: Index#SEC_Contents|Contents]]||[[cvs: Index#Index|Index]]|</p>
</div>

----

<div id="Avoiding-substitution-1"></div>
=== Avoiding substitution ===

Keyword substitution has its disadvantages.  Sometimes
you might want the literal text string
&lsquo;<code>$<i></i>Author$</code>&rsquo; to appear inside a file without
<small>CVS</small> interpreting it as a keyword and expanding it
into something like &lsquo;<code>$<i></i>Author: ceder $</code>&rsquo;.

There is unfortunately no way to selectively turn off
keyword substitution.  You can use &lsquo;<code>-ko</code>&rsquo;
(see [[cvs: Substitution modes#Substitution modes|Substitution modes]]) to turn off keyword
substitution entirely.

In many cases you can avoid using keywords in
the source, even though they appear in the final
product.  For example, the source for this manual
contains &lsquo;<code>$@asis<nowiki>{</nowiki><nowiki>}</nowiki>Author$</code>&rsquo; whenever the text
&lsquo;<code>$<i></i>Author$</code>&rsquo; should appear.  In <code>nroff</code>
and <code>troff</code> you can embed the null-character
<code>\&amp;</code> inside the keyword for a similar effect.

It is also possible to specify an explicit list of
keywords to include or exclude using the
<code>KeywordExpand</code> option in the
&lsquo;<tt>CVSROOT/config</tt>&rsquo; file&ndash;see [[cvs: Configuring Keyord Expansion#Configuring Keyord Expansion|Configuring keyword expansion]]
for more details. This feature is intended primarily
for use with the <code>LocalKeyword</code> option&ndash;see
[[cvs: Keyword List#Keyword List|Keyword list]].

This document was generated on <i>a sunny day</i> using [http://www.nongnu.org/texi2html/ <i>texi2html</i>].
